home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / tdial103.arc / TDIAL103.DOC < prev    next >
Text File  |  1989-01-15  |  24KB  |  695 lines
  1.  
  2.  
  3.  
  4.  
  5.         TDIAL 1.03
  6.  
  7.  
  8.  
  9.  
  10.  
  11.         a product of
  12.         CLASSIC SOFTWARE
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.         Copyright 1988 by CLASSIC SOFTWARE
  57.  
  58.  
  59.  
  60.                                                                   < 2 >
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                    WARRANTY
  70.  
  71.          CLASSIC SOFTWARE makes no warranties, expressed or implied,
  72.          including, but not limited to, merchantability or fitness for
  73.          any particular purpose.  In no event shall CLASSIC SOFTWARE
  74.          be liable for indirect or consequential damages arising from
  75.          the use of the software programs.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.          TRADEMARKS
  113.  
  114.          Telix is a trademark of EXIS.
  115.  
  116.  
  117.  
  118.                                                                < 3 > 
  119.  
  120.  
  121.                                    SHAREWARE
  122.  
  123.          This product is being released as Shareware. Another way of
  124.          putting it, is that this software is being submitted to you
  125.          for your approval.
  126.  
  127.          If you like the TDIAL program and use it, that is, it rates
  128.          your approval, please register and pay for it. If TDIAL does
  129.          not rate your approval then please don't use it.
  130.  
  131.          The registration fee for TDIAL is $10.  A check or money order
  132.          for that amount may be sent to:
  133.  
  134.                                 Claude Dill
  135.                                 CLASSIC SOFTWARE
  136.                                 230 Hibberd Dr.
  137.                                 Centerville, Ohio 45458.
  138.  
  139.  
  140.  
  141.                                                                < 4 >
  142.  
  143.  
  144.  
  145.  
  146.  
  147.          TDIAL -- TELIX -- PC PURSUIT
  148.  
  149.  
  150.          TDIAL is a script to be used to interface TELIX 3.1x to the
  151.          PC Pursuit system.  It is a high speed dialer that handles
  152.          all the dialing chores from the initial connection to the
  153.          local PC Pursuit number, through the selection and dialing
  154.          of the target city, and on to the dialing of the remote
  155.          cities BBS's.
  156.  
  157.  
  158.          Telix, a product of EXIS, is an excellent communications
  159.          program. If you have not yet tried it, you owe it to your-
  160.          self to do so. It has all the features you would expect of
  161.          a modern communications program plus the best script lan-
  162.          guage I have seen. This program is written with the SALT
  163.          script language that is a part of Telix. One final note on
  164.          Telix, it supports INTERNAL Zmodem file transfers. For PC
  165.          Pursuit operation Zmodem is by far the most reliable, and
  166.          in most cases, the fastest protocol available.
  167.  
  168.  
  169.          PC Pursuit is a service of Telenet that offers, for modem
  170.          addicts, an alternative to high long distance bills.  For
  171.          a flat $25 per month you may dial in excess of 25 cities
  172.          nationwide during evening hours and weekends.
  173.  
  174.  
  175.  
  176.                                                                < 5 >
  177.  
  178.  
  179.          What TDIAL Does
  180.  
  181.  
  182.          TDIAL is a script program that must be run after starting
  183.          Telix.  An excellent way of starting both Telix and running
  184.          this script is with the following DOS command (assuming you
  185.          are in the directory where Telix is located).
  186.  
  187.               TELIX STDIAL
  188.  
  189.          Alternately you may run Telix and then use <ALT-G> or a defined
  190.          hotkey ( <F9> is the provided example) to run the TDIAL script.
  191.  
  192.          Either way Telix will be loaded and the script TDIAL will
  193.          be executed.  The script will then do the following:
  194.  
  195.                1. Dial your local Telenet number using Telix's dialer
  196.  
  197.                2. Once connected to Telenet offer you a menu of cities
  198.                   to choose from, or alternately, if you choose, auto-
  199.                   matically start a loop dial on previously selected
  200.                   cities.
  201.  
  202.                3. Once connected to a remote city TDIAL will offer you
  203.                   a menu of BBS's to choose from, or alternately, im-
  204.                   mediately start a loop dial on the boards you have
  205.                   preselected.
  206.  
  207.                4. Once connected to a remote BBS, TDIAL turns control
  208.                   over to Telix. If you have selected a script for the
  209.                   BBS connected to, it will be executed.
  210.  
  211.                5. After terminating the call you can by hitting ALT-D
  212.                   dial other BBS's in the present remote city or by
  213.                   pressing a hot key automatically disconnect from
  214.                   the present remote city and be presented with the
  215.                   menu from which to dial another loop of cities.
  216.  
  217.          For TDIAL to function properly you will have to properly con-
  218.          figure Telix. The following section describes the configur-
  219.          ation procedure. It is highly recommended that you print it
  220.          out before starting.
  221.  
  222.  
  223.  
  224.                                                                < 6 >
  225.  
  226.  
  227.          INSTALLING TDIAL -- CONFIGURING TELIX
  228.  
  229.  
  230.          It is assumed that you have already setup and used Telix
  231.          using the documentation provided by EXIS with Telix.
  232.  
  233.          The following steps will enable TDIAL to work properly with
  234.          TELIX 3.1x.
  235.  
  236.          1. Copy all files from this archive to your Telix directory.
  237.  
  238.          2. Un-arc either MENU-12.ARC or MENU-24.ARC depending on
  239.             your modem speed and Telenet in-dial.
  240.  
  241.          3. Run Telix.
  242.  
  243.          4. From within Telix hit <ALT-D> then <RET> for dialing menu.
  244.  
  245.          5. From Dialing Menu select <O> for other.
  246.  
  247.          6. From "other" dialing menu select <L> for load.
  248.  
  249.          7. Type in CITY
  250.  
  251.          8. Type in <E> for edit.
  252.  
  253.          9. Type in <1> (number one) then <RET> to edit first entry.
  254.  
  255.         10. Change "Phone number" entry to your local Telenet number.
  256.  
  257.         11. Hit return key for other questions.
  258.  
  259.         12. Type <O> for other again.
  260.  
  261.         13. Type <E> (or just hit return) to EDIT_LD.
  262.  
  263.         14. Position menu bar over ! (exclamation mark) and hit return.
  264.  
  265.         15. Type in your id and password for PC Pursuit in the follow-
  266.             ing format:  ,yourid,password.
  267.             example = ,itsme,123xyz
  268.  
  269.         16. After hitting return, be sure and hit <S> to save.
  270.  
  271.                           <<<<* CAUTION *>>>>
  272.  
  273.             There is now a file on your disc called TX.LD that has
  274.             your PC PURSUIT ID and PASSWORD in it. This file is in
  275.             no way encrypted or compiled and can be read by using
  276.             the TYPE command. If others have access to your system
  277.             you may not wish to use this program.
  278.  
  279.  
  280.  
  281.                                                                < 7 >
  282.  
  283.  
  284.         17. <ESC> to exit dialing menu.
  285.  
  286.         18. Hit <ALT-O> for setup.
  287.  
  288.         19. Position menu bar over Modem and Dialing and hit return.
  289.  
  290.         20. Setup as per the following. Note B would be ATDP if
  291.             your local phone has pulse dialing. Note C is a 2
  292.             second delay (your system may work with less delay).
  293.             A,C,E as per your modem. K,L could be shorter or longer.
  294.             N should be off. G seems to be the most common no connect
  295.             strings from the pursuit modems.
  296.  
  297. ╒═╡ Modem and dialing parameter setup ╞══════════════════════════════════════╕
  298. │                                                                            │
  299. │ A - Init string ......... ATZ^M~~~AT S7=45 S0=0 V1 X4^M~                   │
  300. │ B - Dialing prefix 1 .... ATDT                                             │
  301. │ C - Dialing prefix 2 .... ~~~~                                             │
  302. │ D - Dialing prefix 3 .... ATDT                                             │
  303. │ E - Dialing suffix ...... ^M                                               │
  304. │ F - Connect string ...... CONNECT                                          │
  305. │ G - No connect strings .. NO CARRIER             BUSY                      │
  306. │                           ERROR                  NO DIALTONE               │
  307. │ H - Hang-up string ...... ~~~+++~~~ATH0^M                                  │
  308. │ I - Auto answer string .. ~~~+++~~~ATS0=1^M                                │
  309. │ J - Dial cancel string .. ^M                                               │
  310. │                                                                            │
  311. │ K - Dial time ........... 45                                               │
  312. │ L - Redial pause ........ 3                                                │
  313. │ M - Auto baud detect .... Off                                              │
  314. │ N - Drop DTR to hangup .. Off                                              │
  315. │                                                                            │
  316. │                                                                            │
  317. │ Change which setting?       (Return or Esc to exit)                        │
  318. ╘════════════════════════════════════════════════════════════════════════════╛
  319.  
  320.         21. Hit return to exit this screen.
  321.  
  322.         22. Save option changes by hitting <W> on main setup screen.
  323.  
  324.         23. To create a hot key for running TDIAL, either from DOS
  325.             rename TELIX.KE to TELIX.KEY (this makes <F9> the hot
  326.             key) or if you already have a TELIX.KEY file (meaning
  327.             you have redefined your keyboard or created some Macros)
  328.             add a definition for a selected key of:
  329.  
  330.               @TDIAL
  331.  
  332.         24. TDIAL relies on your modem to properly reflect the state
  333.             of the DATA CARRIER signal. For that reason your modem
  334.             must NOT have DATA CARRIER forced on.
  335.  
  336.  
  337.                                                                < 8 >
  338.          USING TDIAL
  339.  
  340.  
  341.          To use TDIAL turn on your modem and boot telix with the fol-
  342.          lowing command:
  343.  
  344.          TELIX STDIAL
  345.  
  346.          or from within Telix hit <ALT-G> and type in TDIAL
  347.  
  348.          If you get a message saying that TDIAL was not found, then
  349.          most probably TDIAL.SLC is not in your script directory.
  350.          (Use <ALT-O> to check for Script Pathname). Assuming Telix
  351.          does find the TDIAL script it should show the version number
  352.          on the screen and dial your local Telenet indial node.
  353.  
  354.          Upon connection to Telenet, TDIAL will sound a two tone
  355.          sequence to alert you, then Telix will display a menu of
  356.          available DIRECT CONNECTS and cities to choose from. You
  357.          may select up to 10 DIRECT CONNECTS and cities, in any
  358.          order, to loop dial on.
  359.  
  360.          Note that when Telix makes a connection the dial menu
  361.          displays CONNECTED HIT ANY KEY. You may hit a key at this
  362.          time if you wish, but it is not neccessary. After a slight
  363.          pause Telix will continue as though you had hit a key.
  364.  
  365.          When a connection is made one of two things will happen.
  366.          If it is a DIRECT CONNECT, Telix will signal with its
  367.          alarm and you will be placed into the terminal mode.
  368.          If the connection made was with a remote city, TDIAL will
  369.          signal with a 3 tone sequence, and then Telix will display
  370.          the BBS directory for the remote city. You may then select
  371.          up to 10 entries to loop on. In either case TDIAL exits.
  372.  
  373.          You may continue to use Telix to dial numbers in the remote
  374.          city for as long as you wish. When you are ready to call a
  375.          new city, hit the "hot key".  As distributed the "hot key"
  376.          is the <F9> key. Once the "hot key" has been pressed TDIAL
  377.          will be run again (alternately if you do not have a "hot
  378.          key" set up you may hit a <ALT-G> and type in TDIAL).
  379.          When TDIAL is rerun it senses that carrier is active and
  380.          does a disconnect from the remote city and uses Telix to
  381.          display the selection of cities again.
  382.  
  383.          You must also do this restart following a connection to a
  384.          DIRECT CONNECT.
  385.  
  386.          The <ESC> key will abort you out of the dialing menu and out
  387.          of the TDIAL script.
  388.  
  389.          If while TDIAL is active, it detects a problem it will warn
  390.          you with an error alarm -- a series of 4 beeps.
  391.  
  392.  
  393.  
  394.  
  395.                                                                < 9 >
  396.  
  397.          AUTOMATING TDIAL
  398.  
  399.  
  400.          You may further automate TDIAL by preselecting the cities
  401.          you wish to loop dial each time you boot up Telix and TDIAL.
  402.          You may also preselect for, each city, a set of boards to
  403.          loop on. TDIAL as distributed is set up to, after connecting
  404.          to Telenet, loop dial on Boston, San Francisco, and Wash-
  405.          ington DC. After connecting to any one of these cities, it
  406.          is set up to immediately start dialing a preselected series
  407.          of boards.
  408.  
  409.          This preselecting is done, in both cases, from within Telix.
  410.          to set up your choice of cities to loop on:
  411.  
  412.            1. Load the CITY menu into the Telix Dialer
  413.  
  414.            2. Edit entry number "one" TELENET
  415.  
  416.            3. Change the password entry to the entry numbers of
  417.               the cities you wish to loop on (seperate entries
  418.               with spaces).
  419.  
  420.      |        If you do not use this feature of TDIAL then be sure to
  421.      |        delete anything in the password. Space filling the password
  422.      |        will cause Telix to issue an "Illegal Dialing Parameter"
  423.      |        message. This is because TDIAL passes whatever is in the
  424.      |        password to Telix as a dialing string.
  425.  
  426.          To set up your choice of boards within any given city:
  427.  
  428.            1. Load the CITY menu into the Telix Dialer
  429.  
  430.            2. Select Edit
  431.  
  432.            3. Choose the entry number for the city you are setting up
  433.  
  434.            4. Change the password entry to the entry numbers of
  435.               the boards you wish to loop on (seperate entries with
  436.               spaces).
  437.  
  438.      |        Again if you elect not to use this feature, be sure that
  439.      |        the password is completely deleted. Spaces or anything else
  440.      |        in the password entry will cause the "Illegal Dialing Para-
  441.      |        meter" message.
  442.  
  443.  
  444.  
  445.                                                                < 10 >
  446.  
  447.          ADDING ENTRIES
  448.  
  449.  
  450.          You may add entries to both the City directory and the in-
  451.          dividual dialing directories as you wish, with but a few
  452.          limitations.
  453.  
  454.            1. Entry number 1 in the CITY menu is for your local
  455.               Telenet dialin.
  456.  
  457.            2. In the CITY menu entries number 2, 3, & 4 are reserved
  458.               for DIRECT CONNECTS. You are free to select any three.
  459.  
  460.            3. The baud rate entry for all the cities should be the
  461.               same as the baud rate selected for the TELENET
  462.               dialin. If you are using 2400 baud and a remote city
  463.               does not support 2400 you would still leave the baud
  464.               rate entry at 2400. The 1200 baud for the remote city
  465.               is selected with the D/*****/12! dialing entry.
  466.  
  467.            4. The dialing prefix for the TELENET entry must be "1".
  468.               The dialing prefix for all the DIRECT CONNECTS and
  469.               cities must be "2". The dialing prefix for the BBS
  470.               entries should be "3". (Although "1" will probably
  471.               work, by using "3" Racal-Vadic mode will be easier
  472.               to implement at a later time. Using "3" also allows
  473.               for people with a pulse dialin to set "1" to ATDP
  474.               and keep "3" at ATDT).
  475.  
  476.            5. The baud rate for all remote BBS's must be the
  477.               same as your TELENET entry. If you dial into PC
  478.               Pursuit at 2400 baud, connect to a remote city, and
  479.               then to a remote BBS and your baud rate for that BBS
  480.               entry is 1200, Telix will down shift to 1200 and you
  481.               will get garbage from the local Telenet dialin.
  482.  
  483.               (An additional word on dialing in to Telenet at 2400
  484.               and connecting to remote boards at 1200. While in the
  485.               terminal mode and during file transfers you will notice
  486.               a jerkiness caused by the speed mismatch. Hopefully all
  487.               of the outdial ports will soon have 2400 capabilities.)
  488.  
  489.  
  490.  
  491.                                                                < 11 >
  492.  
  493.  
  494.          SOUNDS and BACKGROUND OPERATION
  495.  
  496.  
  497.          The main reason for the different tone sequences at different
  498.          times, is that I run Telix and TDIAL primarily as a back-
  499.          ground task.  The tones summarized are as follows:
  500.  
  501.               1. A two tone sequence 660 then 880 means that TDIAL has
  502.                  established a connection with TELENET.
  503.  
  504.               2. A three tone sequence 660,880, then 1100 means a
  505.                  remote city has been reached.
  506.  
  507.               3. Telix's alarm tone will be sounded when connection has
  508.                  been made with either a DIRECT CONNECT or a remote BBS.
  509.  
  510.               4. A series of four beeps means that there is a problem.
  511.  
  512.  
  513.          Using DOUBLEDOS I have found that Telix and TDIAL will run in
  514.          a 205K partition (with a 10K scrollback buffer). Using DESQVIEW
  515.          requires a partition of 190K.
  516.  
  517.  
  518.  
  519.  
  520.                                                                < 12 >
  521.  
  522.       |  CHANGES, ENHANCEMENTS, & BUG FIXES
  523.  
  524.  
  525.       |  Bugs Fixed
  526.  
  527.       |  1. TDIAL was preventing Telix from executing a linked script
  528.       |     after connecting to a BBS. Fixed the code.
  529.  
  530.       |  2. If Telix is set for a default protocol other then the speed
  531.       |     you connect to Telenet at, you would get the message "Telenet
  532.       |     did not ask for Terminal type, ABORTING". Fixed the code.
  533.  
  534.       |  3. If there was a dead remote modem TDIAL did not detect it.
  535.       |     TDIAL passed the BBS list and dialing string to Telix, and
  536.       |     Telix started dialing the dead modem. TDIAL now requires
  537.       |     the remote modem to answer the ATZ string or it aborts with
  538.       |     an appropriate error message.
  539.  
  540.  
  541.       |  Changes & Enhancements
  542.  
  543.       |  1. Error tone has been shortened and made a little more pleasent.
  544.  
  545.       |  2. Included a way for the user to change Telix's Connect string
  546.       |     "on the fly". (In the following XX=12 or 24).
  547.       |     When you connect to Telenet your modem most probably gives your
  548.       |     terminal program the message "CONNECT XX00". When Telenet con-
  549.       |     nects to a remote city it issues a "CONNECT XX00" message. Un-
  550.       |     fortuneately for us not all outdial modems answer with a "CON-
  551.       |     NECT XX00" message. I have observed "CONNECT XX00", "CONNECT",
  552.       |     "ONLINE XX00", and finally just "ONLINE". Telix can only look
  553.       |     for one connect message at a time. As shipped TDIAL looks for
  554.       |     "CONNECT". I have included a program that gives you the ability
  555.       |     to change the connect string Telix is looking for while at-
  556.       |     tached to the outdial modem. (If you choose you can also use
  557.       |     debug -- look near the start of the TDIAL.SLC script).
  558.       |     After running Change you can specify what connect string Telix
  559.       |     should respond to from the outdial modem. I use "NE" as
  560.       |     that is common to all the conNEct/onliNE messages. Sorry to say
  561.       |     that it is also common to "no dial toNE". Fortunately that mes-
  562.       |     sage has been getting rarer. After returning to the CITY menu
  563.       |     Telix will again start looking for the normal CONNECT string.
  564.  
  565.       |  3. Using the CHANGE program also gives you the ability to change
  566.       |     the SET parameters. As shipped TDIAL uses the following:
  567.       |     SET? 1:0,5:1,7:8,0:0,64:7
  568.       |     again you may change this to whatever works best for you using
  569.       |     the CHANGE program. (Debug would work here to.)
  570.  
  571.       |  4. Some internal timing changes were also made.
  572.  
  573.  
  574.  
  575.                                                                < 13 >
  576.  
  577.  
  578.       |   PROBLEMS & FIXES
  579.  
  580.  
  581.       |   If you are experiencing problems the please check the following.
  582.  
  583.       |   1. TDIAL to run properly tracks DCD (also called CD, RSLD, Carrier
  584.       |      Detect, and a few other things). Your modem must not force
  585.       |      DCD. All modems that I have seen either through switches or
  586.       |      through register settings allow the modem to correctly report
  587.       |      the status of DCD. This has caused more problems then any
  588.       |      other one thing. Please check if you are having any kind of
  589.       |      problem.
  590.  
  591.       |   2. Telix default operating speed should normally be set to the
  592.       |      speed you dial into Telenet at. This was a problem in TDIAL101.
  593.       |      It should not be a problem now. (This is what was giving the
  594.       |      Telex did not ask for Terminal Type" message.) Use <ALT-O>
  595.       |      and select terminal options then item "A" to change.
  596.  
  597.       |   3. "Auto baud detect" will cause problems if set to ON. The prob-
  598.       |      lem usually shows up as a failure to match the connect string.
  599.       |      To check this goto "Modem and Dialing settings" and check "M".
  600.       |      Again it should normally be off.
  601.  
  602.       |   4. If you are hanging up at the wrong times, check that the
  603.       |      "Drop DTR to hangup" option is set to off. It is also accessed
  604.       |      from the "Modem and Dialings" settings menu.
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.                                                                < 14 >
  614.  
  615.          One last reminder that this is shareware and that if you use
  616.          this program, please pay for it.
  617.  
  618.          The following page is a mailer that can be used for registering
  619.          TDIAL. Or you may use a conventional envelope and mail to:
  620.  
  621.                        Claude Dill
  622.                        Classic Software
  623.                        230 Hibberd Dr.
  624.                        Centerville Ohio 45458.
  625.  
  626.          All registrations will be acknowledged. Thank You.
  627.  
  628.          If you have problems and/or comments you can reach me on the
  629.          PC Pursuit BBS.
  630.  
  631.  
  632.  
  633.  
  634.           This mailer is provided as a convenience for registering TDIAL
  635.  
  636.  
  637.           Your
  638.                NAME   _______________________________________
  639.  
  640.                ADDRESS_______________________________________
  641.  
  642.                CITY STATE ZIP________________________________
  643.  
  644.  
  645.           Please staple/tape check or money order for $10 to this section
  646.           fold on fold NUMBER 1. Then fold on fold NUMBER 2 and staple/tape
  647.           closed.
  648.  
  649.  
  650.  
  651.   ---------------------  FOLD NUMBER 1  -----------------------
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.     -------------------  FOLD NUMBER 2  -----------------------
  673.  
  674. _________________________________                                     Place
  675.  
  676. _________________________________                                     Stamp
  677.  
  678. _________________________________                                     Here
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.                                          Claude Dill
  687.                                          Classic Software
  688.                                          230 Hibberd Dr.
  689.                                          Centerville Ohio 45458
  690.  
  691.  
  692.  
  693.  
  694.  
  695.